home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 018 / pcfplusb.arc / READ.ME < prev    next >
Encoding:
Text File  |  1987-03-01  |  18.8 KB  |  449 lines
  1.  
  2.        +------------------------------------------------------+
  3.        |  Welcome to "User Supported Software" (Shareware).   |
  4.        |  This remarkable revolution in software distribution |
  5.        |  was  co-pioneered in 1982 by Jim Button and  Andrew |
  6.        |  Fluegelman.  It  has  become a  major  force in the |
  7.        |  software industry, helping to drive software prices |
  8.        |  down and eliminate copy protection schemes.         |
  9.        +------------------------------------------------------+
  10.  
  11.  
  12.               HERE'S HOW USER SUPPORTED SOFTWARE WORKS:
  13.  
  14. You are encouraged to copy the PC-File+ diskettes and share them freely with
  15. others.  You have the luxury of trying out the complete programs, at your
  16. own pace and in the comfort of your own home or workplace.  This is not a
  17. crippled or "demo" copy, but the complete working version of the program.
  18.  
  19. If, after trying out the programs, you decide to continue to use them, you
  20. are trusted to purchase PC-File+ from the program's author, or from an
  21. authorized dealer.
  22.  
  23.  
  24. Why pay at all?
  25. --------------------------------------------------------------
  26.    *  You receive a CURRENT copy of the program
  27.    *  You receive a printed manual (over 240 pages)
  28.    *  One year of technical support - by phone or written
  29.    *  Notification of updates (and fixes, if required)
  30.    *  Inexpensive upgrade offers
  31.    *  Notification of new products
  32.    *  Your input and ideas help shape future products
  33.    *  Periodic offers and "deals" (for our customers only)
  34.    *  Access to the on-line ButtonWare Bulletin Board, which
  35.       means:
  36.         - Information and announcements (on line)
  37.         - Communication with other ButtonWare users
  38.         - More technical support, and helpful tips/pointers
  39.    *  A sense of pride and ownership, in having honestly
  40.       participated in the User Supported software revolution
  41.    *  You help to keep software prices down, by supporting a
  42.       distribution method which doesn't rely on expensive
  43.       advertising campaigns.
  44.  
  45.  
  46. So please, dive in and enjoy the fun of legally sharing good software with
  47. your friends and associates.  But also be aware of the following
  48. restrictions, designed to protect the community of User Supported software
  49. users and authors, and to prevent greedy people from taking unfair advantage
  50. of the trust, hard work, and good will of User Supported software authors:
  51.  
  52. 1. No price or consideration may be charged. However, a distribution cost may
  53.    be charged for the cost of the diskettes, shipping, and handling, so long
  54.    as it's not more than $10 total.
  55.  
  56. 2. The files and programs on the disks may not be modified, deleted, nor
  57.    added to.
  58.  
  59. 3. The programs cannot be sold as part of some other more inclusive package.
  60.  
  61. 4. The programs cannot be "rented" or "leased" to others.
  62.  
  63. 5. The printed manual cannot be copied or reproduced in any way.
  64.  
  65. 6. In the case of distribution via computerized "bulletin boards" or through
  66.    any other telecommunications link the following must be done:
  67.     *  X-Modem or some other error checking protocol must be used
  68.     *  All ButtonWare programs (and documentation files) must be
  69.        transferred in a library format. That means the files have
  70.        all been combined into one file. You can get assistance with
  71.        this procedure from the Technical Support Department at
  72.        ButtonWare.
  73.  
  74. 7. If you're copying the disks for distribution to students in a classroom,
  75.    you must provide them with the following written notice:
  76.  
  77.       +-----------------------------------------------------+
  78.       | These diskettes are distributed to you through the  |
  79.       | courtesy of (your school or instructor name), and   |
  80.       | Jim Button.  No royalty or registration fee has     |
  81.       | been paid for the programs, which are for your use  |
  82.       | and evaluation as a student.                        |
  83.       |                                                     |
  84.       | If you wish to receive technical support from       |
  85.       | ButtonWare, as well as announcements of updates and |
  86.       | improvements to the programs, you must first become |
  87.       | a "registered user."  You do that by purchasing     |
  88.       | each program you plan to use - from an authorized   |
  89.       | dealer or directly from ButtonWare:                 |
  90.       |                                                     |
  91.       |                    Jim Button                       |
  92.       |                  P.O.  Box 5786                     |
  93.       |                Bellevue, WA 98006                   |
  94.       |                                                     |
  95.       | You may also purchase by calling our toll-free      |
  96.       | order line, 1-800-JBUTTON.                          |
  97.       +-----------------------------------------------------+
  98.  
  99.  
  100.                 +-----------------------+
  101.                 | NOTES AND             |
  102.                 | UNDOCUMENTED FEATURES |
  103.                 +-----------------------+
  104.  
  105. The following notes pertain to this version of PC-File+, but were too
  106. late to make it into the manual.
  107.  
  108. ---------------------------------------------------------------------------
  109. Please make certain that the CONFIG.SYS file on your bootup disk contains
  110. this statement:   FILES=20
  111. The number may be 20 or larger. This is covered on page 20 in the manual.
  112.  
  113. If you do not currently have a CONFIG.SYS file on your boot disk you can
  114. add it easily by typing in the following lines after booting up:
  115.     CD  \
  116.     COPY  CON:  CONFIG.SYS
  117.     FILES=20
  118. Press (Enter) after each line. After the last line has been entered press
  119. the F6 key and a ^Z will appear. You should now reboot the computer.
  120. ---------------------------------------------------------------------------
  121. You have a choice of a third color on your screens.  The third color will
  122. be used for additional highlighting.  This helps to make the data stand out
  123. separately from the field names on the screen, easing eye strain and
  124. operator fatigue.  You can set the third color by using the Setup option
  125. from the Utilities command on the master menu screen.  Power users can also
  126. modify the profile files directly, adding the /FG2,n command (see the
  127. "Quick Reference Card")
  128. ---------------------------------------------------------------------------
  129. There is a sample database included on your supplemental programs diskette.
  130. It's called "PEOPLE".  You can use it to keep track of friends,
  131. acquaintances, customers, business contacts, etc.  It also contains
  132. pre-defined smart keys to print mailing labels, phone directories,
  133. envelopes, rolodex cards, etc.  PC-File+ with the PEOPLE database is far
  134. superior to most of the "mailing-list manager" programs on the market.
  135. ---------------------------------------------------------------------------
  136. You can turn TEACH mode on or off from anywhere in the program (not just
  137. from the Master Menu screen as stated in the manual.)  To turn TEACH mode
  138. on or off at any time, press (Alt)T.
  139. ---------------------------------------------------------------------------
  140. "Drop to DOS", (Alt)D, does not work with DOS versions 2.10 or earlier, nor
  141. with Zenith MSDOS 2.11 and Compaq MSDOS 2.12.  This appears to be caused by
  142. a bug in some of the earlier versions of DOS.  We have not had any problems
  143. with later versions of DOS.
  144. ---------------------------------------------------------------------------
  145. There are some other text files on your supplemental program disk
  146. worth taking a look at:
  147.     CHANGES  - detailed account of differences between PC-File+ and
  148.                the previous version of PC-File III or PC-File/R
  149.     PRODUCTS - Short review of ButtonWare products, and an order form
  150.     RESPONSE - A user feedback survey. We really like to receive these
  151.                from you.
  152. ---------------------------------------------------------------------------
  153. In spite of indications in the manual to the contrary, PC-File+
  154. only runs in the FOREGROUND under TopView and Microsoft Windows.
  155. ---------------------------------------------------------------------------
  156.  
  157.  
  158.  
  159. ---------------------------------------------------------------------------
  160. CORRECTIONS TO THE USER'S GUIDE
  161.  
  162. Page 17, Step 4 is should say:
  163.         4. Format the diskette in the B drive
  164.            onto it. This is done by typing:
  165.  
  166.                 FORMAT  B:
  167.  
  168.         If the  FORMAT B:/S  command is used there will not be enough
  169.         free space on the diskette to hold all of the program files.
  170.  
  171. Page 46, largest paragraph, please note carefully:
  172.         The character to place at the end of field names for numeric
  173.         fields is the "#" (pound) sign, not the asterisk. This is
  174.         correctly stated in the manual, but it's easy to get confused
  175.         because of the similar appearance of the two characters.
  176.  
  177. Page 55, add the following sentence at the bottom:
  178.         NOTE: In the super field, scan across only searches the first
  179.         65 characters.
  180.  
  181. Page 82 fails to mention that there are two types of print edit masks
  182.         that can be used to create a floating "check protection" type
  183.         of output. Here are two examples:
  184.         [AMOUNT]:$$$,$$#.##:
  185.             creates a floating dollar sign, example    $12.34
  186.         [AMOUNT]:***,**#.##:
  187.             creates "asterisk filled" output, like  ****12.34
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.              BUTTONWARE FEATURED ON COMPUSERVE AND THE SOURCE
  195.  
  196.  
  197. ButtonWare technical support and ButtonWare products are now featured on
  198. CompuServe Information Service and The Source.
  199.  
  200. Because of the easy accessibility of CompuServe and The Source, ButtonWare
  201. users can easily communicate with us and with each other.  CompuServe and
  202. The Source are available 24 hours a day, and generally do not require long
  203. distance phone calls.
  204.  
  205. The ButtonWare Technical Support Department checks messages every day of
  206. the week.  Online technical support will be available to all ButtonWare
  207. users - whether registered or not.  In addition, answers to common
  208. questions, Shareware copies of the entire ButtonWare product line, and
  209. product descriptions are available.
  210.  
  211. Here is the information for logging onto CompuServe and The Source:
  212.  
  213.     1. CompuServe
  214.         From the CompuServe Top Menu, type:   GO  PCVEN
  215.         Within the PCVEN forum, ButtonWare is subtopic #1.
  216.  
  217.         For more information regarding CompuServe, call 1-800-848-8990.
  218.         Inside Ohio and outside the U.S. call 614-457-8650.
  219.  
  220.     2. The Source
  221.         From The Source prompt, type:   IBMSIG  PRODUCTS  BUTTON
  222.  
  223.         For more information regarding The Source, call 1-800-336-3366.
  224.  
  225.  
  226.  
  227. 
  228.  
  229.          +---------------------------------+
  230.          |  PC-FILE+ QUICK REFERENCE CARD  |
  231.          +---------------------------------+
  232.  
  233.  
  234. SPECIAL KEYS WHEN TYPING
  235.  
  236. KEY                    FUNCTION
  237. -------      ----------------------------------------------
  238. (Alt)D       drop to DOS
  239. (Alt)H       HELP
  240. (Alt)T       TEACH mode (on/off)
  241. (Alt)Y       Smart Key Memorize (on/off)
  242. (Ctrl)A      accept data (same as (F10))
  243. (Ctrl)B      blank right, to end of field
  244. (Ctrl)D      duplicate all of previous record
  245. (Ctrl)F      duplicate Field from previous record
  246. (Ctrl)L      print a Label (Snapshot)
  247. (Ctrl)R      read into memory
  248. (Ctrl)W      write from memory
  249. (Del)        delete the character at the cursor
  250. down arrow   move cursor to following field or line
  251. (End)        cursor right, past last significant character
  252. (Enter)      move cursor to next field
  253. (Esc)        cancel this operation
  254. (F10)        accept data
  255. (Home)       cursor left, to start of field
  256. (Ins)        Insert mode (on/off)
  257. left arrow   move cursor left 1 position
  258. (PgDn)       cursor to last input field on screen, or
  259.                page down (in browse mode)
  260. (PgUp)       cursor to first input field on screen, or
  261.                page up (in browse mode)
  262. right arrow  move cursor right 1 position
  263. tab          move cursor to next field, or
  264.                move browse window one field to the right
  265. tab left     move cursor to prior field, or
  266.                move browse window one field to the left
  267. tilde (~)    the "flip data" character
  268. up arrow     move cursor to preceding field or line
  269.  
  270.  
  271. DEFINING THE DATA BASE
  272.     Special Characters
  273.        #     At the end of the field name creates a numeric
  274.              field.  Example: QTY#
  275.     Edit mask examples:
  276.        :azAZ:     allows only alphabetic characters
  277.        :AAaaEEeeIIiiOOooUUuu: allows only vowels
  278.        :09//--  : good for date fields
  279.     Automatic Fields (In edit mask area)
  280.        :DATE*:      mm-dd-yy         :TIME*:    hh:mm
  281.        :MM/DD/YY*:  mm/dd/yy         :UNIQUE*:  unique no.
  282.        :DD/MM/YY*:  dd/mm/yy         :DUPE*:    auto dupe
  283.        :YYMMDD*:    yymmdd
  284.        :MO*:        mm
  285.        :DY*:        dd
  286.        :YR*:        yy
  287.     Automatic field can also have an input edit mask:
  288.        :DATE*09//:
  289.     Automatic field only when adding records:
  290.        :DATE*A:
  291.     Automatic field only when modifying:
  292.        :DATE*M:
  293.     Automatic Constant
  294.        "New York City"
  295.        "Des Moines"*A         (only when adding records)
  296.        "Milton Freewater"*M   (only when modifying)
  297.     Calculated fields example:
  298.        ((cost + adjustments) / 100).2
  299.     Relational lookup example:
  300.        (@empno,empmast,empno,salary)
  301.  
  302.  
  303. FIND: TYPES OF SEARCHES (SEARCH "SIMPLE")
  304.     xxx         generic (exact, first part)
  305.     ~xxx        scan across
  306.     ?xxx        soundex (sounds like)
  307.     ___x        wildcard
  308.  
  309.  
  310. WHEN CALCULATIONS ARE ASKED FOR:
  311.     example arithmetic calculation:
  312.             ((cost + adjust) / 100)
  313.     example comparison calculation:
  314.             ((age >= 21 & age < 40) & sex = "F")
  315.     arithmetic operators:
  316.         +   addition
  317.         -   subtraction or negation
  318.         *   multiplication
  319.         /   division
  320.         %   modulo (remainder)
  321.         ^   exponentiation
  322.     logical operators:
  323.         &   and
  324.         |   or
  325.     comparison operators:
  326.         =   equal
  327.         !=  not equal
  328.         >   greater than
  329.         >=  greater than or equal
  330.         <   less than
  331.         <=  less than or equal
  332.  
  333.  
  334. COMMANDS WITHIN SMART KEY DATA
  335.     [2]    simulate "blank to right" key
  336.     [4]    simulate "dupe record" key
  337.     [6]    simulate "dupe field" key
  338.     [9]    simulate tab-rt key
  339.     [12]   simulate "Snapshot Label" key
  340.     [13]   simulate (Enter) key
  341.     [18]   simulate "read into memory" key
  342.     [23]   simulate "write from memory" key
  343.     [271]  simulate tab-left key
  344.     [324]  simulate (F10) key
  345.     [328]  simulate cursor up key
  346.     [335]  simulate End key
  347.     [336]  simulate cursor down key
  348.     [338]  simulate Ins key
  349.     [339]  simulate Del key
  350.     ^n     imbed SMART KEY #n
  351.     ^K     get keyboard input
  352.  
  353.  
  354. REPORT COMMAND LANGUAGE
  355.  The sections of the report
  356.   :COVER       prints once at beginning of report
  357.   :HEADING       "    at top of each page
  358.   :DETAIL        "    once for each record printed
  359.   :SUBTOTAL      "    at each subtotal break
  360.   :FOOTING       "    at bottom of each page
  361.   :TOTAL         "    at end of the report
  362.  Commands in print control file (1 command per line):
  363.   [xxx]               field xxx data prints here
  364.   [COUNT*]            print count of records printed so far
  365.   [DATE*]             today's date prints here
  366.   [KEYIN*prompt]      ask operator input, print here
  367.   [PAGE*]             print page number here
  368.   [RECORD*]           print record no. of the current record
  369.   [RECORDS*]          print no. of rcds in database
  370.   [SELECT*]           print the selection criteria
  371.   [SORT*]             print the primary sort field name
  372.   [SUBCOUNT*]         print count of rcds in subtotal group
  373.   [SUBFLD*]           print field name of subtotal break fld
  374.   [SUBID*]            print data from subtotal break field
  375.   [TIME*]             the current time prints here
  376.   A nn,nnn,nn         print ASCII printer control codes here
  377.   <xxx>               field xxx data (excess spaces removed)
  378.   "xxx"               a constant
  379.   =nn                 tab to column nn
  380.   /n                  insert n newlines
  381.   .FF                 form feed to new page
  382.   .CP nn              conditional skip to new page
  383.   (a+b):z,zz#.##:     a calculated answer
  384.   (#):zz,zz#:         relative record number
  385.   (@K1,DB,k2,x2):@@@: relational lookup
  386.  
  387. MAIL-MERGE COMMANDS  (IMBED IN LETTER)
  388.  .<fieldname>            insert data, blanks stripped
  389.  .[fieldname]            insert data, no blanks removed
  390.  .<KEYIN*prompt>         insert data from keyboard
  391.  .<DATE*>                insert today's date
  392.  .GROUP                  start a group (no blank lines)
  393.  .EGROUP                 end a group
  394.  .EGROUP R               end a group, replace blank lines
  395.  .FORMFEED               skip to new page on printer
  396.  .FF                     skip to new page on printer
  397.  .CP nn                  conditional skip to new page
  398.  .<(a+b):z,zz#.##:>      a calculated answer
  399.  .<(@K1,DB2,k2,x2):@@@:> a relational lookup answer
  400.  
  401.  
  402. SORT ALTERNATIVES (SORT FIELD #1)
  403.     fieldname       sort on entire field
  404.     fieldname,1,2   data starts in byte=1, length=2
  405.     fieldname,R     Roman Numeral sort
  406.     fieldname,S     Soundex sort
  407.     RANDOM*         random sequence
  408.  
  409.  
  410. COMMANDS IN PROFILE FILES
  411.  /AUTOSKIP       automatic skip to next field when full
  412.  /BG,n           set background screen color 0-7 (note 1)
  413.  /CASEFIND       searches will be case sensitive
  414.  /CASESORT       sorts will be case sensitive
  415.  /CONDENSED,n,n  ASCII values to cause condensed print
  416.  /DRIVE,x        default disk for data
  417.  /FG,n           set foreground screen color 0-15 (note 1)
  418.  /FG2,n          set alternate foreground color for field names
  419.  /FILE,xxx       default database name
  420.  /KEYIN,xxx      keystrokes to run at startup
  421.  /LBL,xxx        gives Snapshot Label format (note 2)
  422.  /MODPW,xxx      password allowing changes in data
  423.  /NORMAL,n,n     ASCII values to cause normal print size
  424.  /PAGELEN,n      size of page (no. of print lines)
  425.  /PATH,xxx       default subdirectory for data
  426.  /PRPORT,LPTx:   printer output port
  427.  /SORTPW,xxx     password allows sorts on database
  428.  /SYSPW,xxx      password allows system operations
  429.  /USEPW,xxx      password allows use of the database
  430.  /XXXPW,xxx      password allows override of all passwords
  431.  
  432. Note 1.
  433.  Screen colors: bg 0-7, fg 0-15
  434.      0 black   4 red        8 gray        12 lt. red
  435.      1 blue    5 magenta    9 lt. blue    13 lt. magenta
  436.      2 green   6 brown     10 lt. green   14 yellow
  437.      3 cyan    7 white     11 lt. cyan    15 bright white
  438.  
  439. Note 2.
  440.     Snapshot Feature specification:
  441.     dev,t,f,f,f,f......
  442.         dev = LPT1:, LPT2:, MYFILE, etc.
  443.         t   = no. chars to tab in at left margin
  444.         f   = field number, or command
  445.               0   = new line
  446.              -n   = insert n spaces
  447.              'xx' = insert xx (a constant)
  448.  
  449.